package com.library.books.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.library.books.domain.BooksCopy;
import com.library.books.domain.dto.BooksCopyIncrementDto;
import com.library.books.domain.vo.BooksCopyTempVo;
import com.library.books.domain.vo.BooksJoinBooksCopy;
import com.library.books.domain.vo.UserCopyRememberInfo;
import com.library.books.domain.vo.print.PrintRequireInfoData;
import org.apache.ibatis.annotations.Param;

import java.util.List;


/**
 * 书籍副本Service接口
 *
 * @author hb
 * @date 2024-10-14
 */
public interface IBooksCopyService extends IService<BooksCopy>
{

    /**
     * 查询书籍副本列表
     *
     * @param booksCopy 书籍副本
     * @return 书籍副本集合
     */
    List<BooksCopy> selectBooksCopyList(BooksCopy booksCopy);

    /**
     * 查询书籍拼接书籍副本数据
     *
     * @param booksJoinBooksCopy 书籍拼接书籍副本实体类
     * @return 书籍拼接书籍副本集合
     */
    BooksJoinBooksCopy selectBooksCopyJoinBooks(BooksJoinBooksCopy booksJoinBooksCopy);

    /**
     * 查询书籍拼接书籍副本列表
     *
     * @param booksJoinBooksCopy 书籍拼接书籍副本实体类
     * @return 书籍拼接书籍副本集合
     */
    List<BooksJoinBooksCopy> selectBooksCopyJoinBooksList(BooksJoinBooksCopy booksJoinBooksCopy);

    /**
     * 查询书籍拼接书籍副本列表
     *  - 分页数据
     * @param booksJoinBooksCopy 书籍拼接书籍副本实体类
     * @return 书籍拼接书籍副本集合
     */
    List<BooksJoinBooksCopy> selectBooksCopyJoinBooksListByPage(BooksJoinBooksCopy booksJoinBooksCopy);

    /**
     * 查询书籍拼接书籍副本回收列表
     *
     * @param booksJoinBooksCopy 书籍拼接书籍副本实体类
     * @return 书籍拼接书籍副本集合
     */
    List<BooksJoinBooksCopy> selectBooksCopyJoinBooksRecoveryList(BooksJoinBooksCopy booksJoinBooksCopy);

    /**
     * 软删除
     *
     * @param ids id
     * @return 结果
     */
    boolean softDeletion(@Param("ids") Long[] ids);

    /**
     * 恢复书籍副本
     *
     * @param ids id
     * @return 结果
     */
    boolean recoveryBooksCopy(@Param("ids") Long[] ids);

    /**
     * 生成副本模板数据
     *  - 主要是处理索书号（国图书分类 + 自增）的 自增数据保持唯一
     * @param booksCopy 必要的参数
     * @return 模板数据
     */
    @Deprecated
    List<BooksCopyTempVo> generateTemplate(BooksCopyIncrementDto booksCopy);

    /**
     * 批量新增副本数据
     *  - 新增对应待打印数据
     * @param booksCopyList 打印列表
     * @return 当前用户已录入副本数量
     */
    UserCopyRememberInfo batchInsertBooksCopy(List<BooksCopy> booksCopyList);

    /** 正常副本数量
     *  - 能连到编目
     *  - 非软删除
     * */
    Long selectBooksCopyCount();
}
